home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / bbs_util / fmsffs30.zip / FMSFFS.DOC < prev    next >
Text File  |  1994-07-04  |  29KB  |  634 lines
  1. ===============================================================================
  2.  
  3.   From the RBBS Files of        FMSFFS v3.0 Copyright (c) 1993,1994
  4.   The Cellar Door RBBS          By: Daniel T. Drinnon * All Rights Reserved
  5.   Sysop: Dan Drinnon            ===============================================
  6.   Home of the CDOR Mods!
  7.  
  8. ===============================================================================
  9. Purpose:
  10.  
  11. To maintain RBBS FFS and FMS files.  Supports Stock and CDOR RBBS.  Not
  12. crippled in any way.
  13.  
  14. ===============================================================================
  15. Usage:
  16.  
  17. FMSFFS [ConfigFile]
  18.  
  19.           ConfigFile is optional.  The default ConfigFile name is FMSFFS.CFG in 
  20.           the current directory.
  21.  
  22. ===============================================================================
  23. Included Files:
  24.  
  25. FMSFFS   EXE  -  the program
  26. FMSFFS   286  -  the program for 286 cpu's and up
  27. FMSFFS   DOC  -  this documentation
  28. FMSFFS   CFG  -  sample configuration file
  29. FMSFFS   ASK  -  contribution form
  30. FILE_ID  DIZ  -  description file
  31.  
  32. ===============================================================================
  33. ConfigFile Options:
  34.  
  35. The configuration for FMSFFS can contain the following selections:
  36.  
  37.   -----------------------------------------------------------------------------
  38.   LogFile   [drive:][path][filename]
  39.  
  40.       FMSFFS can log activity to the log file if specified here.
  41.  
  42.         Default: NONE
  43.   -----------------------------------------------------------------------------
  44.   LogLevel  n
  45.  
  46.       LogLevel controls the level of log activity to be recorded to LogFile.  A
  47.       value of 0 only records the Begin, End and Abort events.  A value of 1
  48.       or records the Begin, End, Abort and Duplicate Files found.  A value of
  49.       2 records all activity except Duplicate Files found.  A value of 4
  50.       records ALL activity.
  51.  
  52.         Default: 0
  53.   -----------------------------------------------------------------------------
  54.   WorkDir   [drive:][path]
  55.  
  56.       When FMSFFS is running, it creates and uses up to 4 work files.  You may 
  57.       select to have these files created on a RAMDRIVE for extra speed during 
  58.       processing.  The WorkDir must have room for approximatly 3 copies of your 
  59.       FMSFile and approximatly 2 copies of your NameFile.
  60.  
  61.         Default: NONE
  62.   -----------------------------------------------------------------------------
  63.   UseEMS
  64.   UseXMS
  65.  
  66.       When FMSFFS is running it will SHELL to run the Sorter program and, if 
  67.       enabled, the ZIP, PAK, or ARC Command program to extract FILE_ID.DIZ 
  68.       files.  UseEMS and UseXMS tell FMSFFS to use EMS and/or XMS memory to 
  69.       store the image of FMSFFS.EXE to give back more RAM during a SHELL. If 
  70.       both UseEMS and UseFMS are not enabled, then FMSFFS will write its image 
  71.       to DISK.
  72.  
  73.         Default: EMS and XMS DISABLED
  74.   -----------------------------------------------------------------------------
  75.   NoSwap
  76.  
  77.       NoSwap will disable EMS, XMS and DISK SHELL swapping.  Normally, you will 
  78.       always have enough coventional RAM to run the Sorter and Archive programs, 
  79.       so it is reccomended that this option is enabled.
  80.  
  81.         Default: No EMS, XMS or DISK SHELL SWAPPING
  82.   -----------------------------------------------------------------------------
  83.   Sorter    [drive:][path][filename]
  84.  
  85.       FMSFFS must have an external sort program to sort the FFS and FMS files. 
  86.       This program must be able to do an ALPHABETICAL sort and also most be able 
  87.       to sort on different COLUMNS in a file.
  88.  
  89.         Default: QSORT
  90.   -----------------------------------------------------------------------------
  91.   AlphaSort [...]
  92.  
  93.       This is the command line given to the Sorter to do a basic alphabetical 
  94.       sort on an FFS or FMS file.
  95.  
  96.         Default: NONE
  97.   -----------------------------------------------------------------------------
  98.   DateSort  [...]
  99.  
  100.       This is the command line given to the Sorter to do a DATE sort on an FMS 
  101.       file.
  102.  
  103.         Default: /30:2 /24:5 /-1.
  104.   -----------------------------------------------------------------------------
  105.   NameFile  [drive:][path][filename]
  106.  
  107.       The NameFile is the "FIDX.DEF" RBBS index file.
  108.  
  109.         Default: FIDX.DEF
  110.   -----------------------------------------------------------------------------
  111.   LocationFile [drive:][path][filename]
  112.  
  113.       The LocationFile is the "LIDX.DEF" RBBS list file.
  114.  
  115.         Default: LIDX.DEF
  116.   -----------------------------------------------------------------------------
  117.   TabFile   [drive:][path][filename]
  118.  
  119.       The TabFile is the "FIDXT.DEF" RBBS tab file.  RBBS expects this file to 
  120.       be the same as the NameFile with a "T" before the "." in the name.
  121.  
  122.         Default: FIDXT.DEF
  123.   -----------------------------------------------------------------------------
  124.   WriteMode [REPLACE|APPEND]
  125.  
  126.       WriteMode tells FMSFFS how to handle your existing FFS files.  In
  127.       normal use, you will want FMSFFS to REPLACE the FFS files with the
  128.       new FFS files it builds.  Otherwise, FMSFFS will APPEND FFS information
  129.       to your existing FFS files.
  130.  
  131.         Default: REPLACE
  132.   -----------------------------------------------------------------------------
  133.   MakeRFM
  134.  
  135.       If you use Warren Muldrow's RFM mod then you want to uncomment this 
  136.       option.  The CDOR and MAPLE mods automatically detect an RFM modifed FFS 
  137.       NameFile.  Stock RBBS does not support RFM.
  138.  
  139.         Default: NOT ENABLED
  140.   -----------------------------------------------------------------------------
  141.   CDROMDrive      E
  142.  
  143.       If you are using the RBBS/CDOR CDROM mod then you may want to uncomment 
  144.       this option.   The CDOR mods automatically detect a CDROM modified FFS 
  145.       NameFile.  Up to 255 CDROMDrive's may be specified.  Stock RBBS does not 
  146.       support RFM.  Only use this option for the CDOR9404 and later mods.
  147.  
  148.         Default: NOT ENABLED
  149.   -----------------------------------------------------------------------------
  150.   DirectoryExclude  [drive:][path][filename]
  151.  
  152.       If you use the "/S" FileSpec option and there are specific subdirectories 
  153.       you do not want included in the FileSpec search, then you can exclude them 
  154.       with this option.  The [filename] must match the FileSpec [filename] for 
  155.       FMSFFS to match and exclude.  You may specify up to 255 FileSpecExclude's.  
  156.       A subdirectory may only be excluded if FMSFFS knows to exclude it when
  157.       scanning for subdirectories specifed with the FileSpec option and the /S 
  158.       feature.  Therefore, be sure the DirectoryExclude option is listed BEFORE
  159.       the FileSpec option in your FMSFFS.CFG file.
  160.  
  161.         Default: NONE
  162.   -----------------------------------------------------------------------------
  163.   NeverDelete [drive:][path][filename]
  164.  
  165.       FMSFFS will not delete any files during any RFM operations is you give the 
  166.       FULL path and filename here.  Up to 255 NeverDelete's may be specified 
  167.       here.
  168.  
  169.         Default: NONE
  170.   -----------------------------------------------------------------------------
  171.   FileSpec  [drive:][path][filename] [/S] [path] [days]
  172.  
  173.       The FileSpec tells FMSFFS the location of your BBS files.  Normally, you 
  174.       will want to make the [filename] be "*.*".  When you include a "/S", then 
  175.       FMSFFS will search ALL subdirectories below the FileSpec for matches to 
  176.       the [filename].  If you are using Warren Muldrow's RFM mod and have 
  177.       uncommented the MakeRFM config option, then you can also specify a path 
  178.       and number of days to delete files which have not been downloaded or 
  179.       viewed for the number of days specified. Up to 1000 subdirectories may be
  180.       given to the FileSpec however, FMSFFS will always check for available 
  181.       program memory and print an exclamation mark "!" when you have specified 
  182.       more FileSpec's than FMSFFS can handle.
  183.  
  184.         Default: NONE
  185.   -----------------------------------------------------------------------------
  186.   FileNameExclude  [filename]
  187.  
  188.       If you need to prevent FMSFFS from adding specfic files it finds to your 
  189.       FMSFile, then you must tell FMSFFS the NAME of each file here.  You may 
  190.       specify up to 255 FileNameExclude's.
  191.  
  192.         Default: NONE
  193.   -----------------------------------------------------------------------------
  194.   BulletinFile [drive:][path][filename] [days]
  195.  
  196.       If you are using Warren Muldrow's RFM mod, have MakeRFM uncommented, AND
  197.       specified a path and days for FileSpec, then you can also have FMSFFS
  198.       create a Bulletin File listing files which will be deleted soon.  The
  199.       days paramter tells FMSFFS the cutoff days to list files to be deleted.
  200.       For example, if the FileSpec [days] is 30, the BulletinFile [days] is 20
  201.       and today is the 1st of the month, then all files in the FileSpec
  202.       directory which have NOT been downloaded or viewed will be listed in the
  203.       bulletin starting on the 10th (20 days before they will be deleted).  The
  204.       RBBS naming convention for BulletinFile applies here.  If BulletinFile
  205.       is C:\RBBS\BULLETIN\BOLDIES, the FMSFFS will make OLDIES, OLDIESG,
  206.       OLDIESC and OLDIESR (RIP).  The RIP version of the BulletinFile will also
  207.       use the CDOR SmartText {SO and {SN.  Stock RBBS will just output 2
  208.       spaces for these characters.  If the filename you specify is 8 characters
  209.       long, then FMSFFS will only use the first 7 characters.
  210.  
  211.         Default: NONE
  212.   -----------------------------------------------------------------------------
  213.   DirString  [...]
  214.  
  215.       If you are using RBBS macros in your FMS, then you must identify them here 
  216.       so FMSFFS can properly handle them.  It is beyond the scope of this 
  217.       documentation to explain how to use RBBS macros in you FMS files. Please 
  218.       consult RBBS Documentation and also look at the files contained within 
  219.       RBBS-UTL.ZIP for further information.
  220.  
  221.         Default: NONE
  222.   -----------------------------------------------------------------------------
  223.   FileDir [drive:][path][filename]
  224.  
  225.       FileDir works in conjunction with the DirString option.  If you do use the 
  226.       DirString and FileDir options with RBBS macros, please be sure that the 
  227.       FileDir files are formatted the same as your FMSFile. In otherwords, each 
  228.       line in the FileDir should have the same number of characters as in your 
  229.       FMSFile.
  230.  
  231.         Default: NONE
  232.   -----------------------------------------------------------------------------
  233.   FMSFile [drive:][path][filename]
  234.  
  235.       FMSFile is the name of your RBBS FMS file to process.  FMSFFS will only 
  236.       process your FMSFile(s) listed here if they are specified.  FMSFFS will 
  237.       not follow an \FMS CH() specification, so if you do chain your FMS files, 
  238.       then list each one here.  Up to 255 FMSFile's may be specified.
  239.  
  240.         Default: NONE
  241.   -----------------------------------------------------------------------------
  242.   FMSFormat [...]
  243.  
  244.       FMSFormat tells FMSFFS how to sort the FMSFile. By default, FMSFFS will 
  245.       sort your FMSFile by "backwards" date.  Otherwise, FMSFFS will look for 
  246.       "TOP" and/or "NOSORT" in the FMS Header and honor those settings.
  247.  
  248.         Default: NONE (date format)
  249.   -----------------------------------------------------------------------------
  250.   FMSAlpha  [drive:][path][filename]
  251.  
  252.       FMSFFS will optionally create an alphabetically sorted FMS file for you if 
  253.       you specify a filename here.  There is very little overhead to create an 
  254.       FMSAlpha file because FMSFFS will have a alphabetically sort FMS list 
  255.       during its process which is used internally and can also be used for this 
  256.       option.
  257.  
  258.         Default: NONE
  259.   -----------------------------------------------------------------------------
  260.   FMSAlphaHeader [...]
  261.  
  262.       If you specified an FMSAlpha file, then FMSFFS will insert the 
  263.       FMSAlphaHeader on the FIRST line of the FMSAlpha file.  When RBBS is set 
  264.       up with an FMS system, the FMSAlphaHeader is required to tell RBBS how to 
  265.       handle the list.
  266.  
  267.         Default: \FMS TOP NOSORT
  268.   -----------------------------------------------------------------------------
  269.   FMSDate [...]
  270.  
  271.       FMSDate tells FMSFFS how to date FMS entries.  If FMSDate is set to ".", 
  272.       then FMSFFS will use the physical file date as reported by DOS. FMSDate 
  273.       with no parameters will tell FMSFFS to use the date as listed in the 
  274.       FMSFile UNLESS the physical file date as reported by DOS is NEWER than the 
  275.       FMSFile date.  This keeps your FMSFile updated as BBS files get updated, 
  276.       placing updated BBS files towards the newer part of the FMSFile list.
  277.  
  278.         Default: NONE (use FMSFile date)
  279.   -----------------------------------------------------------------------------
  280.   DateSeparator [.]
  281.  
  282.       DateSeparater is a one character value which you would like FMSFFS to use 
  283.       for date listings in the FMSFile.  If this option is not enabled, then the 
  284.       standard date separator is a dash "-".
  285.  
  286.         Default: -
  287.   -----------------------------------------------------------------------------
  288.   FMSDupePath [...]
  289.  
  290.       If FMSFFS finds any duplicate files, it can move these duplicate files to
  291.       a hold directory you specify here.  FMSFFS will move the duplicate file
  292.       which is on the lower numbered drive.  For example, if a duplicate file
  293.       is found in C:\RBBS\FILES and E:\BBS\RBBS, then the file in C:\RBBS\FILES
  294.       would be moved to the hold directory.  If NO path is specified, then
  295.       FMSFFS will simply DELETE the duplicate file.
  296.  
  297.         Default: NONE (do not move dupes)
  298.   -----------------------------------------------------------------------------
  299.   FMSMissing [...]
  300.  
  301.       FMSMissing is a 9 character (or less) text string to be placed in the File 
  302.       Size field of the FMSFile listing for any FMSFile entry which FMSFFS 
  303.       cannot find in the FileSpec or FileDir specifications.
  304.  
  305.         Default: NONE (delete missing FMS files from the FMSFile)
  306.   -----------------------------------------------------------------------------
  307.   UnKnownDesc  [...]
  308.  
  309.       If FMSFFS finds files NOT listed in FMSFile, then it will automatically 
  310.       add the file to the FMSFile and give it the description you specify here.
  311.       In the event of CHAINED FMSFiles, the unlisted file will be added to the
  312.       FIRST FMSFile listed in the FMSFFS.CFG file.
  313.  
  314.         Default: "<Description Unavailable>"
  315.   -----------------------------------------------------------------------------
  316.   FILEID  [filename]
  317.  
  318.       FMSFFS will search all ZIP, ARC and PAK archived files for FILE_ID.DIZ (or 
  319.       whatever filename you specify here) and import the FILE_ID.DIZ text into 
  320.       the FMSFile description.  The FIRST line in the FILE_ID.DIZ will be used 
  321.       as the MAIN description and any remaining lines in the FILE_ID.DIZ will be 
  322.       placed in the extended description.  It will take longer for FMSFFS to 
  323.       look inside archived files for the FILE_ID.DIZ file, so you should only 
  324.       run FMSFFS with this option ONE TIME.
  325.  
  326.         Default: NONE (do not look)
  327.   -----------------------------------------------------------------------------
  328.   GIF
  329.  
  330.       FMSFFS will add GIF dimensions (ex: (640x480x256)) to all GIF files listed 
  331.       in the FMSFile to the MAIN FMSFile description.  FMSFFS will only extract 
  332.       the GIF dimensions and place them in the FMSFile when the FIRST character 
  333.       of the MAIN FMSFile description does NOT start with "(".  The original 
  334.       description will then be appended to the end of the dimensions.  It will
  335.       take FMSFFS longer to extract this information from each GIF file in your 
  336.       FMS so you should run FMSFFS with this option ONE TIME.
  337.  
  338.         Default: NONE (do not extract)
  339.   -----------------------------------------------------------------------------
  340.   KeepExtended
  341.  
  342.       FMSFFS will not overwrite an existing FMSFile extended description if
  343.       this option is enabled.
  344.  
  345.         Default: OVERWRITE
  346.   -----------------------------------------------------------------------------
  347.   MaxExtendedLines [n]
  348.  
  349.       FMSFFS will limit the number of Extended Description lines by what you
  350.       set here.  The maximum allowable extended lines per filename is 199.
  351.  
  352.         Default: 10
  353.   -----------------------------------------------------------------------------
  354.   CategoryChange [old] [new]
  355.  
  356.       FMSFFS can change Category Codes in the FMSFile by using this option.
  357.       Both the [old] and [new] paramters must be specified.  The [old] and
  358.       [new] paramters should be the same length as the FMSCatLen.  You can
  359.       specify up to 255 categories to change.
  360.  
  361.         Default: NONE
  362.   -----------------------------------------------------------------------------
  363.   FMSCatCode [...]
  364.  
  365.       FMSFFS will use the category code specified here for the FMS category for 
  366.       any files it finds not listed in FMSFile.  This option must be a 3 
  367.       character string.
  368.  
  369.         Default: 999
  370.   -----------------------------------------------------------------------------
  371.   FMSDescLen  [..]
  372.  
  373.       FMSFFS can CHANGE the description length of your FMSFile descriptions by 
  374.       what you specify here.  There is no upper or lower limit for this option.
  375.  
  376.         Default: 46
  377.   -----------------------------------------------------------------------------
  378.   FMSExtra [..]
  379.  
  380.       FMSFFS can handle 1 extra FMS FIELD in your FMSFile, such as the Times 
  381.       Downloaded information optionally available with the CDOR mods. If any 
  382.       extra information is included in your FMSFile, then its LENGTH must be 
  383.       specified here.  This field must also be located after the FMS description 
  384.       and before the FMS category.  FMSFFS currently uses FMSExtra specfically 
  385.       for the CDOR Times Downloaded mod.
  386.  
  387.         Default: 0
  388.   -----------------------------------------------------------------------------
  389.   FMSCatLen [.]
  390.  
  391.       This is the length of the Category CODE in the FMSFile.  With current 
  392.       versions of RBBS, this length should always be 3.
  393.  
  394.         Default: 3
  395.   -----------------------------------------------------------------------------
  396.   ZIPCommand [filename]
  397.  
  398.       This is the command to unZIP.  It is used in conjunction with the FILEID 
  399.       filename.
  400.  
  401.         Default: PKUNZIP
  402.   -----------------------------------------------------------------------------
  403.   ARCCommand [filename]
  404.  
  405.       This is the command to unARC.  It is used in conjunction with the FILEID 
  406.       filename.
  407.  
  408.         Default: PKXARC
  409.   -----------------------------------------------------------------------------
  410.   PAKCommand [filename]
  411.  
  412.       This is the command to unPAK.  It is used in conjunction with the FILEID 
  413.       filename.
  414.  
  415.         Default: PKUNPAK
  416.  
  417. ===============================================================================
  418. Notes and Pratical Applications:
  419.  
  420.   Speed
  421.  
  422.       FMSFFS has been tideously coded to give the highest throughput during its 
  423.       runtime operation.  There are certain configuration options that will 
  424.       affect the speed of FMSFFS's processing time:
  425.  
  426.          WorkDir -
  427.            Your WorkDir should be a RAMDrive or your fastest Hard Drive
  428.  
  429.          UseEMS,UseXMS -
  430.            Any time FMSFFS SHELLS to sort files, it will swap itself to
  431.            EMS,XMS or DISK for more memory  unless you turn these options
  432.            off and use the NoSwap option.  Generally, you will not want to
  433.            use EMS, XMS or DISK swapping unless your system does not have
  434.            enough memory to run the ZIP, ARC or PAK commands.  These options
  435.            will most noticably slow FMSFFS down when FILEID is active.
  436.  
  437.          MakeRFM -
  438.            When this option is enabled, FMSFFS must reindex the FIDX file.
  439.            This does not take much time, but does add an extra process to
  440.            the operation.
  441.  
  442.          FileNameExclude, DirectoryExclude -
  443.            If you exclude Filenames or Directories, then FMSFFS must check
  444.            the FileSpec's you told it to look in for matches.  The more
  445.            exclusions, the longer it takes.
  446.  
  447.          FMSFile -
  448.            When FMSFile is specified, then FMSFFS will process your FMS
  449.            after processing your FFS.  If all you need to do is process
  450.            your FFS files, then comment FMSFile out.  When CHAINING FMS
  451.            files, FMSFFS must reindex each file in your FMSFiles which
  452.            invloves one extra process while FMSFFS runs.
  453.  
  454.          FMSAlpha -
  455.            Creating an FMSAlpha file will slow FMSFFS down slightly.
  456.  
  457.          FMSMissing -
  458.            When you have FMSFFS check your FMSFile for filenames which are
  459.            not on your HD or CD-ROM, then FMSFFS will verify your FMSFile
  460.            against the FIDX files before processing the FMSFile.
  461.  
  462.          FMSDupePath -
  463.            If FMSFFS must copy all duplicate files it finds, then there will
  464.            be some slowdown.  This option should normally be run only once.
  465.  
  466.          FILEID,GIF -
  467.            Needless to say, checking archived files for FILE_ID.DIZ files
  468.            will take a lot more time than a normal run.  You should only
  469.            use these options once on an FMSFile you want to add FILE_ID.DIZ
  470.            descriptions and/or GIF dimensions to.  CD-ROM drives will
  471.            greatly affect FMSFFS's operation depending on the speed of the
  472.            drive.  For every filename in your FMSFile, FMSFFS will open and
  473.            search for FILE_ID.DIZ or extract the GIF dimensions, depending
  474.            on the filename's extension.
  475.  
  476.          KeepExtended -
  477.            This option will stop FMSFFS from looking for FILE_ID.DIZ in
  478.            files listed in your FMS which already have an extended
  479.            description.
  480.  
  481.       In summary, the following options, in descending order, are the
  482.       biggest time hogs with FMSFFS:
  483.  
  484.            FILEID
  485.            UseEMS,UseXMS (with FILEID)
  486.            GIF
  487.            FMSDupePath (when moving duplicates)
  488.            FMSMissing
  489.  
  490.       The other options listed above affect FMSFFS's operation acutely.
  491.  
  492.  
  493.    Daily Operations
  494.  
  495.       There are basically 2 ways to use FMSFFS in a day-to-day basics for
  496.       your BBS.  As a daily event, you can run FMSFFS against all your BBS
  497.       files for regular maintenance.  If you run a front end system such
  498.       as BinkleyTerm or Front Door, sometimes your system may receive
  499.       network files which you process with a "TIC" tosser.  If your "TIC"
  500.       tosser places incoming network files anywhere BUT your default RBBS
  501.       upload subdirectories, then callers will see the new file in your
  502.       FMSFile list, but will not be able to download it because it is not
  503.       in the FFS FIDX.DEF list.  So, you can make part of your "TIC"
  504.       processing also run FMSFFS, but, make FMSFFS use a special
  505.       FMSFFS.CFG file which has the FMSFile line commented out.  This will
  506.       make FMSFFS rebuild the FFS files only and save time by not processing
  507.       large FMSFiles.
  508.  
  509.  
  510.    Periodic Operations
  511.  
  512.       Occasionally, you may want to run FMSFFS with the FILEID and/or GIF
  513.       options enabled to catch missing FILE_ID.DIZ descriptions and GIF
  514.       dimensions in your FMSFile.
  515.  
  516.  
  517.    Making New FMSFiles
  518.  
  519.       FMSFFS does not need an existing FMSFile to run.  If the FMSFile
  520.       is not found, then it assumes you want to make a new one.  When
  521.       this happens, all FMSFile entries will have the UnKnownDesc for
  522.       the description and the current date unless you are using the "."
  523.       for FMSDate.
  524.  
  525.       Because of the way FMSFFS operates, you must have an existing FMSFile
  526.       to use the FILEID and/or GIF options.  Even if these options are
  527.       enabled, they will not be active when FMSFFS is creating a NEW
  528.       FMSFile.  To use these options, run FMSFFS a second time.
  529.  
  530.  
  531.    RFM considerations
  532.  
  533.       When you are using the MakeRFM option, FMSFFS uses your current
  534.       FIDX.DEF file to extract the FIDX.DEF DATE field.  This means
  535.       FMSFFS has to search through your old FIDX.DEF file for matches to
  536.       the creent FIDX.DEF file that FMSFFS creates.  This is normally not
  537.       a problem, but if you were to exclude files from your FMS that were
  538.       previously in your FMS, then FMSFFS has to go through more data
  539.       in the old FIDX.DEF to find a match.  This may slow the process down
  540.       and if it does, you may want to just DELETE your old FIDX.DEF and
  541.       let FMSFFS make a new one.
  542.  
  543.       FMSFFS handles the RFM procedure the same as Warren Muldrow's RFM
  544.       does in respect to the FMSFile specification.  For example, the
  545.       following line:
  546.  
  547.       FileSpec   C:\RBBS\FILES\*.*   C:\RBBS\OLDFILES  180
  548.  
  549.       Means all files in C:\RBBS\FILES will be moved to C:\RBBS\OLDFILES
  550.       after 180 days inwhich any file in this subdirectory was not viewed
  551.       or downloaded.  Needless to say, you do NOT want to use the RFM
  552.       options unless your RBBS can handle it.  Further:
  553.  
  554.       FileSpec   C:\RBBS\FILES\*.*  /S  C:\RBBS\OLDFILES  180
  555.  
  556.       Means files below C:\RBBS\FILES will be moved as well when their time
  557.       has come.
  558.  
  559.  
  560.    Duplicate Names
  561.  
  562.       If FMSFFS comes across duplicate filenames, it will only use the
  563.       first file found for the FFS and FMS files.  The order of the
  564.       first file is determine by the FileSpec.  If FMSDupePath is uncommented,
  565.       then FMSFFS will move the duplicate to a holding area if you
  566.       specify a path, or simply delete the duplicate if there is no path
  567.       specified.
  568.  
  569.  
  570.    ESC
  571.  
  572.       To abort FMSFFS, press ESC!  When you do this, FMSFFS will restore
  573.       as much as possible before finishing.
  574.  
  575.  
  576.    Temp Files
  577.  
  578.       FMSFFS will create, use and delete various work files.  Given your
  579.       NameFile is FIDX.DEF and your FMSFile is MASTER.DIR, the following
  580.       files will be created, used and then deleted in the current directory
  581.       FMSFFS is excuted in or the WorkDir, if specified:
  582.  
  583.          FIDX.WRK
  584.          MASTER.WRK
  585.          MASTER.SRT
  586.          MASTER.EXT
  587.  
  588.  
  589. ===============================================================================
  590. History:
  591.  
  592. 061993 - * Initial BETA release
  593. 062693 - * Fix for extended descriptions with same dates in a date ordered
  594.            FMS but NOT in alpha order as secondary sort causing problems.
  595.          * Fix for FMSDate "." option
  596. 071093 - * some fixes for creating final master.dir file with no ext. desc.
  597. 073193 - * Beta release of version 2 Beta
  598. 080193 - * fix for alpha.dir header and format output
  599.          * fix for \FMS lines
  600.          * fix for entries in FMS.DIR not online trashing FMS.DIR
  601.          * enabled FMSMissing Option
  602. 080293 - * fix for rfm type fidx file going skewed with unlisted files
  603. 080893 - * fix for invalid DOS filedates when using FMSDate .
  604. 030694 - * Version 2.1 is now from the BASIC version due to problems with
  605.            previous C versions.
  606. 070494 - * Version 3.0 Major Revisions in code!
  607.  
  608. ===============================================================================
  609.  
  610. DANIEL T. DRINNON IS NOT RESPONSIBLE TO YOU FOR DAMAGES, INCLUDING BUT NOT 
  611. LIMITED TO, ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, GENERAL, INCIDENTAL 
  612. OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE (INCLUDING 
  613. BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES 
  614. SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 
  615. PROGRAMS) OR ANY OTHER LOSS EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF 
  616. SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  617.  
  618. ================================================================================
  619. Liscense:
  620.  
  621.            You are authorized to USE this program as long as you would like.
  622.            This program is fully functional as distributed and requires NO 
  623.            registration or intervention for it's execution.  Contributions
  624.            are gladly accepted - see FMSFFS.ASK!
  625.  
  626. ================================================================================
  627.  
  628. Dan Drinnon
  629. The Cellar Door RBBS
  630. 505-784-3187
  631. FidoNet: 1:318/1
  632. RBBSNet: 8:903/2
  633.  
  634.